home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #336 (1994-06)(Rhein-Sieg-Soft).zip / Franz PD Disk #336 (1994-06)(Rhein-Sieg-Soft).adf / MUGiff / English.lha / MUGiff.English next >
Text File  |  1993-02-09  |  18KB  |  412 lines
  1. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»«««««««««««««««««««««««««««««««««««««
  2. »»»»»»»»»»»»»                                                 «««««««««««««
  3. »»»»»»»»»»»»»»D o c u m e n t a t i o n   f o r   M U G i f f««««««««««««««
  4. »»»»»»»»»»»»»                                                 «««««««««««««
  5. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»«««««««««««««««««««««««««««««««««««««
  6.  
  7.                             © 1993 by Mark Rose
  8.  
  9.   THIS  PROGRAM  IS  MAILWARE.  THE COPYRIGHT AND ALL MEANS OF EXPLOITATION
  10. REMAIN  PROPERTY  OF  THE  AUTHOR.   IT  MAY  BE  FREELY DISTRIBUTED IF THE
  11. FOLLOWING REQUIREMENTS ARE MET:
  12.  
  13.   1. NO  MONEY MAY BE CHARGED FOR THE DISTRIBUTION OF THIS PROGRAM EXCEPT A
  14.      NOMINAL  FEE  FOR  EXPENSES.   THIS  FEE  MUST NOT EXCEED 5.- DM (FIVE
  15.      GERMAN  MARKS  IN  WHATEVER  CURRENCY).
  16.  
  17.   2. THE DOCUMENTATION (ENGLISH AND GERMAN), THE SOURCECODE, EXECUTABLE AND
  18.      ALL  OTHER  FILES OF THIS DISTRIBUTION REMAIN INTACT AND UNCHANGED AND
  19.      *MUST* BE DISTRIBUTED TOGETHER.
  20.  
  21.   3. THIS  PROGRAM  MUST NOT BE USED IN ANY COMMERCIAL WAY.  IF YOU WANT TO
  22.      USE  THIS PROGRAM IN ANY COMMERCIAL FORM PLEASE CONTACT THE AUTHOR AND
  23.      TERMS CAN BE NEGOTIATED.
  24.  
  25.   THE  AUTHOR  TAKES NO RESPONSIBILITY FOR ANY DAMAGE THAT RESULTS FROM THE
  26. USE OF THIS PROGRAM.
  27.  
  28.  
  29.   THE  AUTHOR  ESPECIALLY  ENCOURAGES  THE  INCLUSION  IN THE 'AMOK' (AMIGA
  30. MODULA  UND OBERON KLUB), 'FRED FISH AMIGA FREELY DISTRIBUTABLE LIBRARY'
  31. SERIES AND THE XPK-DISTRIBUTION.
  32.  
  33.  
  34. =_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=
  35.    Since in the last versions nobody had the 'grace' to drop me a single
  36.  line (even by EMail which does not cost anything) I changed the status of
  37.                               this program to
  38.  
  39.                               M A I L W A R E .
  40.  
  41.    This means that everybody who uses this program longer than a day is
  42.       REQUIRED to send me mail by any means. Otherwise he is a pirate
  43.                             (and a louse, too).
  44. =_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=
  45.  
  46.  
  47. What MUGiff is:
  48. »»»»»»»»»»»»»»»
  49.  
  50.   Yet another IFF-viewer. But... (see next section)
  51.  
  52.  
  53. Features:
  54. »»»»»»»»»
  55.  
  56.   - Displays just any ILBM imagineable (except nested IFFs)
  57.  
  58.   - KS  1.2,  1.3,  2.04,  3.0 compatible (NO direct AGA-support, but could
  59.     work  though.   Please report to me).  Fixed since 1.6.  I stupidly re-
  60.     duced  colors  to prevent bad IFFs from consuming too much memory.  HEY
  61.     AGA USERS OUT THERE!  Report to me, please!
  62.  
  63.   - Runs  on  ANY  Amiga (hopefully) thanks to IFF-library.  Tested on A500
  64.     (512Chip,512Fast)  KS1.2,  A2000C  (1MB  Chip,  4MB Fast16, 4MB Fast32)
  65.     68030/881 KS2.04/KS3.0, A500 (2.3MB Fast, Kick 2.0).
  66.  
  67.   - Can  display any number of pictures (under KS2.04, because of unlimited
  68.     commandline length)
  69.  
  70.   - XPK-support. XPKmaster.library must be installed though.
  71.  
  72.   - EXTREMELY SHORT! This version: 7052 bytes! (+ iff.library 3164 bytes)
  73.  
  74.   - Supports  OverScan (even under KS1.2/1.3).  This is done in a NOT KS2.0
  75.     way!  Works though ;)
  76.  
  77.   - IFF24bit  pictures  can  be  displayed.   Because  of  a  limitation in
  78.     IFF.library it is just the red part.  The only other way (as in ShowIFF
  79.     of  the  library)  would be to load the complete 24bit bitmap into CHIP
  80.     and 400×400 would be the limit (1meg CHIP).
  81.  
  82.   -   >>NEW SINCE 1.03<<
  83.     Pictures  larger  than  the  screen  can  be  scrolled without limiting
  84.     multitasking  at  all  (no  mousemovement, no CPU-time!  In contrast to
  85.     ShowIFF which calls GetMsg all the time).
  86.       >>NEW SINCE 1.04<<
  87.     The IDCMP-loop is done faster now, speeding scrolling up on 68000 based
  88.     Amigas (suggested by Thies Wellpott on Fish 771).
  89.  
  90.   -   >>NEW SINCE 1.06<<
  91.     MUGiff  now  invokes  the  ReqTools  FileRequester  when no argument is
  92.     supplied AND ReqTools has been installed.
  93.  
  94.   -   >>NEW SINCE 1.06<<
  95.     Several  bugs  were  removed (see 'History.DEF' for details) and MUGiff
  96.     now  runs  very reliable and stable on MY machine (well, I wrote it for
  97.     myself in the first place so this is the main feature...  ;^) )
  98.  
  99.   -   >>NEW SINCE 1.06<<
  100.     MUGiff  now comes with handdrawn Icons!  Why this?  Workbench usability
  101.     was greatly improved (e.g. ability to suppress annoying WB-window).
  102.  
  103.   -   >>NEW SINCE 1.09<<
  104.     MUGiff  now  supports MultiSelection!  Especially useful for disk-based
  105.     systems.  Select all the files you want and display them.
  106.  
  107.   -   >>NEW SINCE 1.10<<
  108.     Finally  the  ability to save uncompressed IFF-pictures has been added.
  109.     With  XPK  (HUFF 100%) you can save 2 up to 20KBytes.  Please note
  110.     that this version has MORE features but is SHORTER!
  111.  
  112.   -   >>NEW SINCE 1.11<<
  113.     Now  you can play animations!  You can even crunch your animations with
  114.     XPK!   Gives  much  better  results than PowerPacker AND MUGiff is 6000
  115.     bytes  shorter  than  PPShow  (though  not as feature packed)!  Combine
  116.     pictures  and  animations of any type and watch!  This version is again
  117.     SHORTER (550 Bytes!) than the previous!
  118.  
  119.   -   >>NEW SINCE 1.11<<
  120.     Tested with the new ENFORCER (Fish 800)! I couldn't find a single hit!
  121.  
  122.  
  123. Known Features:
  124. »»»»»»»»»»»»»»»
  125.  
  126.   Oops! This should read Bugs of course... 8þ
  127.  
  128.   This  is a bug in iff.library:  Some XPK-packed EHB pictures are declared
  129. "non-iff"  by  the  OpenIFF routine.  I have exactly ONE picture that shows
  130. this  behaviour  (out  of  hundreds).  It is AnarchyDragon of the Party'92.
  131. Other crunched EHB-pictures just work fine... (BTW I use HUFF 100%)
  132.  
  133.   The  save  routine  (new since 1.10) has problems with EHB-pictures.  The
  134. colortable  seems  to  be  too short.  I couldn't locate this problem in my
  135. program (I just call SaveBitMap).  My guess is that iff.library looses some
  136. bytes when counting colors but this will be checked more thoroughly...
  137.  
  138.   MUGiff  seems  to loose some bytes of FastRam if used in conjunction with
  139. ReqTools.  The amount is exactly that of the FileList of ReqTools.  After a
  140. while  (some  program  calls)  the  memory  magically  reappears.   I  call
  141. 'FreeFileList'  for sure but it seems that ReqTools takes some time to free
  142. the memory.  So do not blame me for temporary memory losses!
  143.  
  144.  
  145. Installation:
  146. »»»»»»»»»»»»»
  147.  
  148.   Very  easy:  just copy the IFF.library and ReqTools.library (depending on
  149. the Kickstart version you have) to your LIBS:  directory (either by hand or
  150. using  the  provided scripts), put MUGiff somewhere in your path (e.g.  C:)
  151. and all the fun can begin...
  152.  
  153.   ReqTools  is  NOT explicitly needed by MUGiff (it checks for ReqTools V38
  154. and  if  it is not found it the FileRequester is disabled).  But if you use
  155. MUGiff  regularly  in  a  shell  environment or from Workbench I suggest to
  156. install ReqTools to save your poor little fingers...
  157.  
  158.                                »»»»»»»»»»»»»
  159.                                » REMEMBER: »
  160.                                »»»»»»»»»»»»»
  161.  
  162.                   IFF.library is © by Christian A. Weber
  163.                   ReqTools.library is © by Nico François
  164.  
  165.  
  166. Usage:
  167. »»»»»»
  168.  
  169.   CLI: Just start it  with the name(s) of the picture(s).
  170.   ----
  171.        Example: MUGiff DH0:IFFs/THEpic.IFF DF0:WoC.HAM RAM:Irving.face.ugly
  172.  
  173.          While displaying the picture you can scroll around using the mouse
  174.        (if  the  picture  is  larger  than  the  screen).  If more than one
  175.        picture  was  supplied  as argument you can display the next picture
  176.        with  the  left  mousebutton (or press any key) and abort the entire
  177.        display with the right mousebutton.
  178.  
  179.          Since  1.6  you  needn't  provide an argument at all.  This causes
  180.        MUGiff  to look for ReqTools.library.  If it can find the library it
  181.        will  open a FileRequester for you and (since 1.9) you can select as
  182.        many  files  as you want to.  Just hold down the SHIFT-key and click
  183.        on  the  files  you  want  to  view.   You  can also use the gadgets
  184.        provided  by the requester (which should be self-explanatory but for
  185.        full documentation see ReqTools.doc)
  186.  
  187.          A  new feature has been added since 1.10:  The ability to save the
  188.        currently  displayed  picture.   Just  press 's' and the old picture
  189.        will  be  overwritten  with  an  uncompressed  version  and the next
  190.        picture (if any) will be displayed.  This way you can convert MBytes
  191.        of  pictures  for  use  with  better  packers than RunLengthEncoding
  192.        (RLE).   ATTENTION:   see  the  section  'Known  Features' for a bug
  193.        occuring with EHB-pictures!
  194.  
  195.          Since  1.11  MUGiff  is also able to play animations (ANIM OPT 5)!
  196.        You  can  use the same selection methods as for pictures.  To finish
  197.        the  playback  press  CTRL  + C and the next file will be displayed.
  198.        You  can  mix animations and pictures any way you want to (ideal for
  199.        presentations).
  200.  
  201.   WB : 1. Make  MUGiff  the default-tool of your picture icon, double-click
  202.   ----    it and enjoy
  203.  
  204.        2. Via  extended  selection.   That is click on the MUGiff icon with
  205.           the  mouse and hold down the shift-key.  Then double-click on the
  206.           picture icon(s).  (and enjoy yourself THEN).
  207.  
  208.        3. If  you have ReqTools installed:  double-click on the MUGiff icon
  209.           and  a  FileRequester  will appear.  Choose your file(s) (Details
  210.           can be found in 'CLI'-section above).
  211.  
  212.          The  program  automatically  opens a window to display information
  213.        about  the  pictures  (resolution,  depth and wether it is an iff or
  214.        not).   If  this annoys you (especially the 'press >>RETURN<<') give
  215.        the  icon an ToolType entry "WINDOW=NIL:".  You can also specify the
  216.        dimensions of the window:
  217.  
  218.        "WINDOW=CON:0/0/1024/1024/ReallyBIGwindow/AUTO/CLOSE/MyPublicScreen"
  219.  
  220.        (the latter three for Kick 2.04 users only).
  221.  
  222.        See CLI (above) for more features and details...
  223.  
  224.  
  225. Hardcore Techno:
  226. »»»»»»»»»»»»»»»»
  227.  
  228.   This  program  was written to be as system-friendly as possible.  No busy
  229. loops  or  any  other  anti-multitasking  methods  are used.  All memory is
  230. dynamically  allocated.   All resources are freed (look at 'Known features'
  231. for details).  All references to bitmaps are via Screen^.rastPort.bitMap as
  232. suggested  by  C=  for  future  compatibility.  The screen-swapping for the
  233. animplayer is done by ScreenToFront and a WaitTOF for synchronization.
  234.  
  235.   The  annoying CTRL + C (at least for mousicians) was chosen because it is
  236. the  shortest  (in  code)  and  most  compatible way for request in a loop.
  237. GetMsg  would be no good because there can be messages even if the user did
  238. nothing  (refer  to  RKM:   Libraries  for  details).  A timer.device based
  239. asynchronous  routine  would be nice but I doubt it to be shorter and it is
  240. too  much  work just to test (yes, I AM lazy ;^) ).  If you want to you can
  241. implement it yourself and send it to me for release.
  242.  
  243.   MUGiff  is  intended to be as short a possible (and NOT using assembler),
  244. KS  1.2/1.3 compatible and to have all features that are not in contrast to
  245. the last two.
  246.  
  247.  
  248. Tips for using MUGiff:
  249. »»»»»»»»»»»»»»»»»»»»»»
  250.  
  251.   "Why doesn't this damned program support wildcards ???"
  252.  
  253.   Very  easy.   It  is designed to be used in such tools as Directory Opus,
  254. DiskMaster  or similar.  Put it in a gadget there and it will feel at home.
  255. This will also prevent that your fingers bleed due to too excessive typing.
  256.  
  257.   "I want MUGiff to have an AppIcon !"
  258.  
  259.   With the highest probability this will NEVER come true.  I do not need it
  260. and  as  egoistic  as I am I would never struggle to program something I do
  261. not have any use for.  But in the unexpected case that dozens of people cry
  262. for it...  (sigh, moan)
  263.  
  264.   "Why is there no FileRequester ?"
  265.  
  266.   Well, check your version of MUGiff.  Since 1.6 there it is:  the ReqTools
  267. FileRequester.  You must have installed ReqTools though. Since 1.9 there is
  268. also the possibility to select many files at the same time.
  269.  
  270.   "I would like to see the #? feature added"
  271.  
  272.   Patience.   First  try  reading  the next section for things to come.  If
  273. your  desires  are not met there just contact me ("how" is explained at the
  274. end  of  this  file).  If it is a feature I need myself you will find it in
  275. the  next  version.   If it is not more people should ask for it and I will
  276. implement it (sigh again).
  277.  
  278.   "MUGiff is desperately in need of a WYSIWYG editor, an art package (where
  279.    else  should  the  pictures  come from?), a Tetris-clone (preventing the
  280.    pictures  from  being  too boring), GameBoy(tm) implementation, 32768bit
  281.    Halfbrite-mode  (Kick  19.0) support and should become shorter (no space
  282.    on my WB-disk)."
  283.  
  284.   Exactly!   How  about a software 68040 emulator, that is able to simulate
  285. 16meg RAM on a stock A600 1MB and is 327% faster?         AAAARRRRGGGGHHHH!
  286.  
  287.  
  288. What will there be in future versions:
  289. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  290.  
  291.   In order of probability:
  292.  
  293.   - This  is  probably  the  last  Modula-2  version.   Since my SAS/C copy
  294.     arrived  this  week  it  is just a matter of time when the port to C is
  295.     done.   But  first  I'll  have  to  work  through  hundreds of pages of
  296.     manual...
  297.     If you want to purchase M2Amiga 4.1d contact me! ];^}
  298.  
  299.   - PCHG-support.  You could finally crunch these fantastic pictures (which
  300.     are  also  fantastically  large)  with  XPK  and still view them!  This
  301.     feature has become more likely due to the availability of a C-compiler.
  302.  
  303.   - I cannot think of any more things to add. Tell me what you want.
  304.  
  305.  
  306. Bug-Reports:
  307. »»»»»»»»»»»»
  308.  
  309.   A  bug  in  one  of MY programs?  IMPOSSIBLE !!!  UNTHINKABLE !!!  But in
  310. case that perhaps despite that...
  311.  
  312.   Please  send  the reports to the address below.  EMail would be VERY nice
  313. because   of   the   mindboggling   speed.    Please  tell  me  your  exact
  314. configuration.   The  specifications  of  the  picture  and the kind of bug
  315. should  also be described with detail.  If possible send me the picture for
  316. testing (UUEncoded via EMail for example).
  317.  
  318.   If  this  documentation  contains  mistakes (grammatical and/or spelling)
  319. please  tell me so I can correct them.  You perhaps noticed that English is
  320. not my native tongue...
  321.  
  322.  
  323. Support:
  324. »»»»»»»»
  325.  
  326.   If you want to get the newest version faster than anyone else does do one
  327. of the following things (depending on where you live):
  328.  
  329.   Europe [that is the EEC]: Send  five  German  Marks to the address below.
  330.                             If  you  want  to use a different currency, add
  331.                             one  Mark  because  the  bank  likes to get its
  332.                             share... Use EuroCheques or cash (NO COINS!)
  333.  
  334.   Outside Europe [not EEC]: Send  five US-Dollars to the address below.  If
  335.                             you  can  get  your hands on a check drawn on a
  336.                             German bank, use it.  Otherwise please use cash
  337.                             only  (bank  fees  are too expensive, more than
  338.                             5DM anyway)
  339.  
  340.   It  would  be  very  kind if you would send a self-addressed envelope for
  341. easier  handling.   The  disk  is supplied by me and included in the price.
  342. This  disk  will  contain  the newest version of MUGiff (of course) and the
  343. newest distribution of XPK, IFF.library and ReqTools.
  344.  
  345.   As you can see the requested money has no margin for profit.  If you like
  346. MUGiff please remember this program is MailWare.  Thank You.
  347.  
  348.  
  349. How to contact me:
  350. »»»»»»»»»»»»»»»»»»
  351.  
  352.   There are many ways. Here they are in order of preference:
  353.  
  354.   - Via EMail    : ukkg@ibm3090.rz.uni-karlsruhe.de
  355.                                             »InterNet«         no UUEncoded
  356.                                             binaries! I cannot save mail to
  357.                                             disk there!
  358.  
  359.                    ukkg@dkauni2.bitnet      »BitNet« same as above
  360.  
  361.                    s_rose@iravcl.ira.uka.de »InterNet«if there are problems
  362.                                             to  contact  me   under   above
  363.                                             addresses [did happen!]
  364.  
  365.   - Snail Mail   : Mark Rose                  Mark Rose
  366.                    Waldhornstr. 36, D604      Franz-Volk-Str. 37
  367.                    7500 Karlsruhe             7600 Offenburg
  368.                    GERMANY                    GERMANY
  369.                    (during Semester)          (you may always reach me there
  370.                                                but may take a while...)
  371.  
  372.  
  373. Acknowledgements:
  374. »»»»»»»»»»»»»»»»»
  375.  
  376.   Thanks to: Nico François for his great ReqTools.library
  377.  
  378.              Christian  Weber  for his IFF.library.  This one did save me a
  379.                LOT of work (especially porting some nested C-code...)
  380.  
  381.              Fred   Fish   for   providing  the  AMIGA-community  with  the
  382.                incredibly  good  AmigaLibDisks  which  served the community
  383.                better than every A4000!  Please continue your great work!
  384.  
  385.              the AMIGA for being the best computer in the world.
  386.  
  387.              Markus  Welte,  Heby,  Michael Renz and Andreas Krebs, my very
  388.              helpful ß-testers (and source of a lot of work ;^) ).
  389.  
  390.  
  391.  
  392.  
  393. +-------------------------------------------------------------------------+
  394. |           T H I S   P R O G R A M   I S   M A I L W A R E  !            |
  395. +=========================================================================+
  396. |  Please remember: This program is MailWare.  If you like it and use it  |
  397. |   on a regular basis, think of the poor student who appreciates small   |
  398. |       amounts of mail that tell him how great/average/bad/&$§#?!*       |
  399. |   his program is. So  M A I L  me at once and have a clear conscience   |
  400. +-------------------------------------------------------------------------+
  401.  
  402.  
  403. ___________________________________________________________________________
  404.  ____   ONLY   ____  _____  ____
  405. | __ ||\    /||_  _|| ____|| __ |  "Harry : What do you recommend for a
  406. ||__||||\  //|  ||  || ___ ||__||           hangover?
  407. | __ |||\\//||  ||  |||___|| __ |   Annie : Teetotaling and prayer.
  408. ||  |||| \/ || _||_ ||___||||  ||   Cooper: Good answer.
  409. ||  ||||    |||____||_____|||  ||   Harry : I'll try some coffee."
  410.              makes it possible...                                Twin Peaks
  411. ___________________________________________________________________________
  412.